PC Media 6

home *** CD-ROM | disk | FTP | other *** search

/ PC Media 6 / PC MEDIA CD06.iso / share / prog / pcs20 / pcshell.doc < prev next >

Wrap

Text File | 1995-01-01 | 24.6 KB | 794 lines

_______ ____|__ | (TM) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER POWER C SHELL VERSION 2.0 Copyright 1991 by Chuck Steenburgh & Tay-Jee Software Page 1 TABLE OF CONTENTS Distribution Limitations. . . . . . . . . . 3 ASP Ombudsman . . . . . . . . . . . . . 3 Disclaimer . . . . . . . . . . . . . . 3 Starting Power C Shell Version 2.0 . . . . . . 6 Environment variables 6 Running Power C Shell 7 Configuring PCS 7 Installing PCS 8 Power C Shell Menu Options . . . . . . . . . 9 Files Menu 9 Operations Menu 10 Configuration Menu 11 Quit Menu 13 Help . . . . . . . . . . . . . . . . 13 Page 2 DISTRIBUTION LIMITATIONS: This is a copyrighted shareware program. You have a limited license to try out this soft- ware on a single computer for a period of 30 days. If you continue to use the software after this 30-day trial period, you must become a registered user. OMBUDSMAN This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman, 70007,3536. DISCLAIMER The program described in this documentation is guaranteed to do absolutely nothing! It has, however, in my experience performed essentially as described herein. The author will not be responsible for any loss or damages caused through the use of these programs. No warranty, express or implied, is provided for this software's performance, merchantability, or fitness for a particular purpose. All trademarks are property of their respective owners. In particular, "Power C" is a registered trademark of MIX Software. The program and documentation are Copyright 1991 by Chuck Steenburgh & Tay-Jee Software. You are encouraged to distri- bute these programs provided the following conditions are met: - all files contained in the archive or distribution disk must be distributed together in UNMODIFIED form - you charge no more than a $7 fee for copying or sub- scription, and clearly indicate that payment of such a fee does NOT grant ownership of the programs. You may evaluate this program for up to 30 days on a free trial basis. After 30 days, you should register your use of the program. The registration fee is $20, payable to Tay-Jee Software at the address given below. Please see the file REGISTER.FRM on the distribution disk/archive. Registration does have its advantages: - I am improving the program all the time. Registration Page 3 will get you IMMEDIATELY a disk with the latest version. You will also get the next major release of the program set sent to you free of charge. - While I can't promise to include everyone's suggestions in program updates, you can bet I'll listen to registered users before any of you scrounges out there. - You will make me feel all warm and fuzzy and appreciated, and all that good stuff. - You will also get an evaluation copy of my text file for- matting program (used to produce the margins in this doc- ument), and any other electronic creations I have decided to unleash on a foolish, unsuspecting world. - Registered users can obtain the source code for the program at the cost of an additional $10. Send comments/registrations to: Tay-Jee Software Post Office Box 835 Lexington, VA 24450 (703)464-5290 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!! CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums) Now that the semi-legal mumbo-jumbo is out of the way, welcome to POWER C SHELL Version 2.0. This program began as a simple aid to Power C programmers and blossomed into a much more am- bitious project. POWER C SHELL Version 2.0 has the following features: - Simplifies editing, compiling, and debugging of POWER C programs without having to fool with the DOS command line - Customizable editor and viewer (use your favorites), or use the very handy TDE public domain editor in- cluded in the package - Customizable compile & link options for Power C compiler (with help screens to explain them all) - Ability to review C.ERR error listing without leaving the shell - Test run your executable programs without leaving the shell - Easy, one-step loading of complete projects Page 4 - Customizable screen colors - Context-sensitive help (although the program is so simple, I doubt you'll need it) Page 5 STARTING POWER C SHELL VERSION 2.0 Power C Shell itself requires approximately 130K of free memory to run. To this amount, however, you must add the greater of the memory required by your editor, viewer, and whatever C program you happen to be working on. Power C Shell remains in memory when these programs are executing. The Power C compiler, version 2.0.1, requires about 256K of free memory. Basically, a 512K machine or better is a safe bet, al- though you might get by with only 384K available. Environment Variables ===================== Power C Shell can configure itself through the use of environment variables. Power C Shell understands the following environment variables: PCEDIT: complete path of your editor PCEDITP: any command line parameters used by your editor PCVIEW: complete path of your viewer PCVIEWP: any command line parameters used by your viewer PCOPTIONS: default compile options to be used by PC.EXE PCLINK: default link options to be used by PCL.EXE Environment variables are established by use of the DOS SET command. To set the name of your viewer to C:\LIST.COM, simply type the following at the DOS command line: SET PCVIEW=C:\LIST.COM Use a similar procedure to set the other variables. To set your default compile options to "/e/ms" (link file, use small memory model), type the following on the DOS command line: SET PCOPTIONS=/e/ms If, while entering your environment variables, you get the message "Out of environment space" or something similar, you need to edit your CONFIG.SYS file. Look for a state- ment similar to the following: SHELL=c:\dos\command.com c:\dos /p To increase the environment space, change the statement to something like this: SHELL=c:\dos\command.com c:\dos /p /e:384 In the example above, 384 is the new number of bytes re- served for the environment (160 is the default). DOS will Page 6 always round this number to a multiple of 16. 384 bytes should be enough for most users, although you may need more. The limit is 32,768, although there should never be a need for more than 1 or 2K. See your DOS manual for more de- tails on setting the environment size. Note that you must reboot your computer after editing your CONFIG.SYS file for any changes to take effect. The PCEDITP and PCVIEWP parameter variables assume that your editor and viewer accept command line switches AFTER the filename to edit/view. For example: <PCEDIT> (filename) <PCEDITP> edit program.c -x -e If your editor/viewer only accept parameters and switches BEFORE the filename, enter them as part of the PCEDIT or PCVIEW varaibles. For example: <PCEDIT> (filename) edit -x -e program.c you would enter the following command on the DOS command line prior to starting Power C Shell: SET PCEDIT=edit -x -e Environment variables will override any options contained in the PCSHELL.CFG configuration file. Running Power C Shell ===================== The syntax for starting Power C Shell is as follows: PCS2 [filename] [/D-] [/H] [filename] optional parameter specifying complete name of source file to work on [/D-] optional parameter telling PCS to ignore its configured starting directory and use the current directory [/H] display a brief help screen Configuring PCS =========== === Prior to using PCS, you will have to configure it. You may do this either through the environment variables described above or through the Configuration pull-down menu detailed below. At Page 7 a minimum, you will need to specify the name of your editor and any compile options you would like used with the Power C. Installing PCS ========== === It is recommended, but not necessary, to copy the PCS2.EXE program file to the same directory containing your Power C com- piler. If you would like to be able to use PCS from any direc- tory, make sure the PCS2.EXE file is placed in a subdirectory contained in your DOS PATH. If you would like to use the TDE editor with PCS, place the TDE program files in a directory accessible to PCS. If this directory is not also on your DOS PATH, you will have to specify the COMPLETE path for TDE when you configure PCS. Page 8 POWER C SHELL MENU OPTIONS Files Menu ===== ==== Pressing the Alt-F key combination will activate the Files pull-down menu, which contains the following options: Open Selecting this menu choice will allow you to open a file for editing and/or compiling. Up to seven files, all belonging to the same project, may be open at one time in PCS v2.0. After selecting this item, you'll be asked to enter a wildcard file specification. The default is *.C; however, you may enter any value you like. A list of all files matching the entered wild- card pattern will be displayed in a box centered on the screen. Using the cursor keys, position the highlight bar over the name of the file you would like to open and then press <Enter>. If you open a Power C project file with a .PRJ extension, all of the associated source files of the project will be opened. NOTE: This project file MUST be in PCS 2.0 format for this to work properly. If you open a project file while other files are open, they will be closed first and then the project will be loaded. If more than one file is open, you will be asked to choose an "active file." The active file is the file which is loaded by the "Edit" menu choice described below. Enter the file number (1-7) of the file which you would like to be active. A pair of flashing exclamation points appears next to the name of the active file. New file Selecting this menu item will allow you to type the name of a new C source file on upon which to begin work. Do NOT enter the name of a project (*.PRJ) file. Again, if multiple files are open, you will be asked to select the active file. Switch Selecting this item will allow you to change the active file. Edit Selecting this menu item will invoke your editor and load the currently active file for editing. Page 9 Close This option allows you to remove a file from the list of open source files. Type the number of the file you wish to close in the dialog box. If more than one file remains open, you will be asked to designate a new active file. All Close This option will remove ALL files from the open list. Print This option allows you to print one or more files associated with the current project. In the dialog box that appears, press "A" to print all source files, "I" to print the project #include file (*.H), or the number of a single open file. Next, you'll be asked to specify which printer port (LPT1-3) to print to. If there is an error, PCS will inform you of the nature of the problem and provide you with the opportunity of correcting it or aborting the print operation. Directory This option allows you to change the current working direc- tory. Enter a drive letter, directory, or complete path, as appropriate, into the dialog box. Any open files will be closed upon changing directories. Operations Menu ========== ==== Pressing the Alt-O key combination activates the Operations pull-down menu, which contains the following options: Compile Selecting this item invokes the Power C compile and compiles the currently open source file(s). Any compile options speci- fied through the PCS configuration file or environment variables will eb in effect for the compilation. The compile listing will appear on the screen and you will have the opportunity to view it prior to return to PCS. To pre- vent the listing from scrolling off the screen, include the #pragma pagesize preprocessor directive in your program source. Page 10 Link The current project or source file will be linked, using the options specified through the configuration file or environment variable. The executable file produced will have the same name as the first open file, with the extension .EXE. Header Selecting this option will invoke your editor and load the project #include (*.H) file. Using such a file is an easy way to declare external variables by using the #include file in supplementary project source code modules. View C.ERR This option will invoke your viewer and allow you to see the contents of the most recent compile listing (contained in the C.ERR file generated by PC.EXE). DOS Shell This option allows you to return momentarily to the DOS com- mand line without exiting PCS 2.0. A reminder will appear in your prompt informing you to type "exit" to return to PCS. While you are in the DOS Shell, keep in mind that your total free memory is reduced by approximately 130k. Configuration Menu ============= ==== Pressing the Alt-C key combination will activate the Con- figuration pull-down menu, which includes the following op- tions: Editor Selecting this option will allow you to enter the name of your editor. In the first dialog box, enter the complete path and file name of your editor program. In the second dialog box, enter any command line parameters (switches) required by your editor, if any. The editor name and switches will then appear on the appropriate line in the status area at the bottom of the screen. Viewer Page 11 This option allows you to configure your viewer program. Follow the steps above for the editor, this time typing the path and switches for the viewer. Compile Options This option will allow you to select which switches are to be used by the Power C compiler. The PC.EXE file's help screen will be displayed and a small dialog box will appear at the bot- tom of the screen. Enter your choice into the box. Link Options This menu choice will allow you to specify link options. A small help screen explaining the available switches will be presented. Enter your switch(es) in the dialog box. Memory Allocations With this option you can control the size of the stack, heap, and far heap of your program. Enter values for each of these items in the dialog box just as you would enter them on the com- mand line. For example, if you want 16k of memory for the stack enter "16k"; if you want 800 bytes allocated for the heap, enter "800." Object Library Select this option to enter the name of an object file to be linked as a library. This can be a library of your own creation or a third-party library. Make use of the "?" wildcard to spec- ify different library names for the three memory models. For example, PCS is linked with the library CJSLIBM.MIX, a library of functions developed by Tay-Jee Software. By entering the name "CJSLIB?.MIX" as an object library, the files CJSLIBS.MIX, CJSLIBM.MIX, or CJSLIBL.MIX will be linked depending upon which memory model is in effect. (See the Power C README file for a further discussion of libraries and wildcards.) Program Colors Selecting this option activates the program color selection process. Nine screen elements can have their screen attributes individually configured. Enter the number of the screen color you wish to modify, then position the flashing star character over the appropriate color combination, then press <Enter>. Once you are through selecting colors, enter "0" instead of a color number. In the dialog box which appears, type N to put Page 12 your newly selected colors into effect, O to ignore the new colors and use the colors in currently in effect, or D to revert to the program's default color scheme. Quit ==== Select this option to leave Power C Shell and return to DOS. Three options are available: "Yes" exits PCS immediately; "Save" updates the PCSHELL.CFG file with the current settings, then returns to DOS; and "No" returns you to PCS. HELP Context-sensitive help is available from within the PCS menu system (only). From the main PCS screen, or from within any pull-down menu, pressing <F1> activates the help system. A box will appear on the middle of the screen containing the help information for the currently selected menu operation. Use the cursor movement keys to scroll the help text up and down through the box. Pressing <Esc> returns you to PCS. A short help line appears for most dialog boxes in PCS. Most "basic" editing functions, such as Insert/Delete and Backspace work normally in dialog boxes. In addition, the <Tab> key can be used to DELETE all information in a dialog box which lies to the right of the cursor. This document formatted with MARGARINE 3.0ß, a utility program I created using Power C 2.0.1 and Power C Shell. Look for it in IBM Systems/Utilities Forum (IBMSYS) on CompuServe (found in the New Uploads or General Utilities Library as MARG*.ZIP). Page 13